• Add ToggleCertificateGenerationView endpoint to enable/disable certificate generation
• Add CertificateExceptionsView endpoint to grant and remove certificate exceptions (allowlist)
• Add CertificateInvalidationsView endpoint to invalidate and re-validate certificates
• Update certificate status labels to be more user-friendly (e.g., "Received" instead of "already received")
• Update certificate generation history labels (e.g., "All Learners" instead of "All learners")
• Add invalidation notes to IssuedCertificateSerializer
• Add certificates_enabled flag to CourseInformationSerializerV2

Description

This PR adds comprehensive v2 API endpoints for certificate management in the instructor dashboard, supporting the new React-based instructor dashboard UI.

Changes include:

• New API Endpoints:

  • POST /api/instructor/v2/courses/{course_id}/certificates/toggle_generation - Enable/disable certificate generation for a course
  • POST /api/instructor/v2/courses/{course_id}/certificates/exceptions - Grant certificate exceptions (allowlist) to learners
  • DELETE /api/instructor/v2/courses/{course_id}/certificates/exceptions - Remove certificate exceptions
  • POST /api/instructor/v2/courses/{course_id}/certificates/invalidations - Invalidate certificates for learners
  • DELETE /api/instructor/v2/courses/{course_id}/certificates/invalidations - Re-validate (remove invalidation) certificates

• Data Model Updates:

  • Updated certificate status labels to be more user-friendly:
    • "downloadable" → "Received"
    • "notpassing" → "Not Received"
    • "unavailable" → "Invalidated"
    • "error" → "Error State"
    • "audit_passing" → "Audit - Passing"
    • "audit_notpassing" → "Audit - Not Passing"
  • Updated certificate generation history labels:
    • "All learners" → "All Learners"
    • "For exceptions" → "Granted Exceptions"

• Serializer Enhancements:

  • Added invalidation_note field to IssuedCertificateSerializer to include notes about certificate invalidations
  • Added certificates_enabled flag to CourseInformationSerializerV2 to indicate if certificate management is available

Key Features:

• Bulk operations support with detailed error handling - returns separate success and error lists
• Validation checks to prevent invalid operations (e.g., granting exceptions to non-enrolled users, invalidating already-invalidated certificates)
• Proper permission checks using existing instructor permissions

User Roles Impacted:

• Instructors/Course Staff - Can manage certificate exceptions and invalidations through the new instructor dashboard UI

Supporting information

Related to the instructor dashboard v2 modernization effort.

Testing instructions

1. Toggle Certificate Generation:

   curl -X POST /api/instructor/v2/courses/{course_id}/certificates/toggle_generation \
     -H "Authorization: Bearer {token}" \
     -d '{"enabled": false}'

   Expected: Returns {"enabled": false}

2. Grant Certificate Exceptions (bulk):

   curl -X POST /api/instructor/v2/courses/{course_id}/certificates/exceptions \
     -H "Authorization: Bearer {token}" \
     -d '{"learners": ["user1", "user2@example.com"], "notes": "Test exception"}'

   Expected: Returns success/error lists for each learner

3. Remove Certificate Exception:

   curl -X DELETE /api/instructor/v2/courses/{course_id}/certificates/exceptions \
     -H "Authorization: Bearer {token}" \
     -d '{"username": "user1"}'

   Expected: Returns success message

4. Invalidate Certificates (bulk):

   curl -X POST /api/instructor/v2/courses/{course_id}/certificates/invalidations \
     -H "Authorization: Bearer {token}" \
     -d '{"learners": ["user1", "user2@example.com"], "notes": "Reason for invalidation"}'

   Expected: Returns success/error lists for each learner

5. Remove Certificate Invalidation:

   curl -X DELETE /api/instructor/v2/courses/{course_id}/certificates/invalidations \
     -H "Authorization: Bearer {token}" \
     -d '{"username": "user1"}'

   Expected: Returns success message

Deadline

None

Other information

• These endpoints follow the same patterns as other v2 instructor API endpoints
• No database migrations required - uses existing models
• Backwards compatible - does not modify existing v1 endpoints
• Frontend PR: [link to frontend-app-instruct PR when created]